Skip to main content

GetBucketLifecycle

Description

GetBucketLifecycle is used to view the Lifecycle configuration of Bucket.

Request Method

POST

Request Path

/apsara/route/OneRouter/GetBucketLifecycle

Request Parameters Common Parameters

NameLocationTypeRequiredSample valueDescription
StatusBODYstringNoNo sample value for this parameter.If the value is Enabled, OSS will periodically execute the rule; If it is Disabled, OSS will ignore the rule.
ExpirationBODYcontainerNoNo sample value for this parameter.specifies the expiration attribute of the object lifecycle rule.
LifecycleConfigurationBODYcontainerNoNo sample value for this parameter.Lifecycle configured container can hold up to 1000 rules.
PrefixBODYstringNoNo sample value for this parameter.Prefix to which the rule applies. If Prefix is specified, this rule only applies to objects in Bucket that match Prefix. If Prefix is left blank, this rule applies to all objects in the Bucket.
versionBODYstringNo2016-01-01version of api
AbortMultipartUploadBODYcontainerNoNo sample value for this parameter.specifies the expired attribute of incomplete multipart upload.
CreatedBeforeDateBODYstringNoNo sample value for this parameter.Specify a date, and OSS will execute lifecycle rules on data whose last update time is earlier than that date. The date must obey the ISO8601 format and must be the zero point of UTC. for example: 2002-10-11T00:00:00.000Z, which means that objects with the last update time earlier than 2002-10-11T00:00:00.000Z are deleted or converted to other storage types, and objects equal to or later than this time will not be deleted or dumped.
regionIdBODYstringYesNo sample value for this parameter.region id
DaysBODYpositive integerNoNo sample value for this parameter.specifies how many days after the lifecycle rule takes effect from the last update of Object.
ValueBODYstringNoNo sample value for this parameter.Tag Value
IDBODYstringNoNo sample value for this parameter.unique ID that identifies the rule. It consists of up to 255 bytes. If it is not specified or the value is empty, OSS automatically generates a unique ID.
RuleBODYcontainerNoNo sample value for this parameter.identifies a rule.
TagBODYcontainerNoNo sample value for this parameter.specifies the object label to which the rule applies, and multiple labels can be set.
KeyBODYstringNoNo sample value for this parameter.Tag Key

Return data

NameTypeSample valueDescription
RequestIDstring1E3D5A1E0-67CA-43DA-24BC-EAF2D5A1E4DCRequest id

Example

Successful Response example

{
"RequestID":"1E3D5A1E0-67CA-43DA-24BC-EAF2D5A1E4DC"
}

Failed Response example

{
"errorSample":
{
"resultCode":-1,
"resultMsg":"system error",
"result":null
}

}